Download Installer Enhanced

Route

/v2/installer/{platform}/{version}

Description

Download installer with enhanced platform and version options. This endpoint provides access to specific installer versions with additional configuration options.

Method

GET

Inputs

Parameter	Type	Required	Description
platform	string	Yes	Target platform (windows, macos, linux)
version	string	Yes	Installer version (e.g., "25.04.1", "latest")
architecture	string	No	System architecture (x64, arm64, x86)
format	string	No	Installer format (msi, exe, pkg, deb, rpm)
configuration	string	No	Pre-configuration profile ID
deployment_group	string	No	Target deployment group

Query Parameters

GET /v2/installer/windows/25.04.1?architecture=x64&format=msi&configuration=config-123

Output

Field	Type	Description
Binary Data	file	Installer binary file

Response Headers

Header	Description
Content-Type	application/octet-stream
Content-Disposition	attachment; filename="cyberhaven-installer-{platform}-{version}.{format}"
Content-Length	File size in bytes
X-Installer-Version	Actual installer version
X-Installer-Platform	Target platform
X-Installer-Architecture	Target architecture
X-Installer-Checksum	SHA256 checksum of the file

Rate Limit

• 10 downloads per minute per API key
• 2 concurrent downloads per endpoint

Platform Support

Windows

• Architectures: x64, x86
• Formats: msi, exe
• Versions: 25.03.0+

macOS

• Architectures: x64, arm64 (Apple Silicon)
• Formats: pkg
• Versions: 25.03.0+

Linux

• Architectures: x64, arm64
• Formats: deb, rpm
• Versions: 25.04.0+

Example Usage

Download Latest Windows Installer

curl -H "Authorization: Bearer YOUR_API_KEY" \
  "https://api.cyberhaven.com/v2/installer/windows/latest?architecture=x64&format=msi" \
  -o cyberhaven-installer.msi

Download Specific macOS Version

curl -H "Authorization: Bearer YOUR_API_KEY" \
  "https://api.cyberhaven.com/v2/installer/macos/25.04.1?architecture=arm64&format=pkg" \
  -o cyberhaven-installer.pkg

Download with Pre-configuration

curl -H "Authorization: Bearer YOUR_API_KEY" \
  "https://api.cyberhaven.com/v2/installer/linux/latest?format=deb&configuration=config-456" \
  -o cyberhaven-installer.deb

Error Responses

Version Not Found

{
  "errors": [
    {
      "code": 404,
      "message": "Installer version 25.02.0 not found for platform windows"
    }
  ]
}

Unsupported Platform/Architecture

{
  "errors": [
    {
      "code": 400,
      "message": "Architecture arm64 not supported for platform windows"
    }
  ]
}

Invalid Configuration

{
  "errors": [
    {
      "code": 400,
      "message": "Configuration profile config-invalid not found"
    }
  ]
}

Notes

• The latest version always returns the most recent stable release
• Pre-configuration profiles must be created through the admin console
• Deployment groups allow for staged rollouts and testing
• All installers are digitally signed and include automatic update capabilities
• Downloaded installers include embedded configuration when specified